Skip to main content

Utilizzo dell'interfaccia della riga di comando

Puoi iniziare CODESYS.exe dalla riga di comando con le seguenti opzioni e argomenti.

Sintassi:

<installation folder>CODESYS.exe --<Option>

Nota

Se hai utilizzato il CODESYS Installer per installarne più di uno CODESYS istanze sul tuo computer, devi utilizzare il file --additionalfolder opzione per specificare l'istanza da avviare.

Suggerimento

I percorsi oi parametri delle opzioni devono essere scritti tra virgolette diritte quando contengono spazi, trattini o barre.

Opzione: --additionalfolder

Si applica solo alle installazioni effettuate con il CODESYS Installer:

Se hai installato più istanze di a CODESYS versione e si desidera avviare una delle istanze dalla riga di comando, vale quanto segue: oltre al profilo è necessario indicare anche il percorso assoluto della AddionalFolder/<instance name> con il --additionalfolder opzione.

Contesto: il CODESYS Installer crea un AdditionalFolders sottocartella nella directory di installazione in CODESYS cartella. In questa cartella è presente una sottocartella separata per ciascuna CODESYS istanza con i singoli file per profilo, plug-in e PackageDB. Per la prima istanza installata, viene denominata la sottocartella Default. Alle istanze aggiuntive viene assegnato il nome di installazione assegnato durante l'installazione.

È possibile visualizzare il percorso assoluto da specificare --additionalfolder In CODESYS Installer quando fai clic su Modifica pulsante nel riquadro dell'istanza pertinente. È registrato come Posizione.

Sintassi:

--additionalfolder=<AdditionalFolders\<instance installation name>>
Esempio 44. Esempio

Due istanze di CODESYS 3.5.18.20 è stato installato sul tuo computer con il CODESYS Installer: uno per i tecnici dell'assistenza, uno per gli sviluppatori. Vuoi eseguire il Service istanza tramite a StartServiceScript.py script dalla riga di comando. Per fare ciò, specifica l'opzione --additionalfolder dopo l'opzione --profile sulla riga di comando come segue:

"C:\Program Files (x86)\CODESYS3.5.18.20\CODESYS\Common\CODESYS.exe" --profile="CODESYS V3.5 SP18 --additionalfolder="C:\Program Files\CODESYS 3.5.18.20\CODESYS\AdditionalFolders\Service"  --runscript="D:\Dokumente\Scripting\StartServiceScript.py"--scriptargs:'username password 3.14 "path=\"C:\temp\\\""'–noUI


Opzione: --culture (lingua dell'interfaccia utente)

CODESYS viene avviato nella lingua specificata.

Sintassi:

--culture=<Culture>

<culture>: I codici lingua tipici sono i seguenti: de, en, fr, it, es, zh-CHS.

Esempio 45. Esempio

Di partenza CODESYS con l'interfaccia utente in inglese:

CODESYS.exe --culture=en


Opzione: --profile (CODESYS profilo)

CODESYS viene avviato direttamente con il profilo specificato. Quando inizi CODESYS senza questa opzione, il Seleziona Profilo si apre.

Sintassi:

--profile="<profile name>"

<profile name>: Devi specificare il nome del profilo esattamente come viene visualizzato nel file Aiuto → Informazioni su schermata iniziale del sistema di sviluppo o nel menu di avvio del computer.

Esempio 46. Esempio
CODESYS.exe --culture=de --profile="CODESYS V3.6"


Opzione: --compare (avvia il confronto del progetto)

A seguito di CODESYS è iniziato, il confronto di due CODESYS i progetti vengono avviati immediatamente. Dopo l'opzione, specificare prima il "progetto corrente" e poi il "progetto di riferimento" come argomenti. CODESYS avvia e apre il Confronto di progetti – Differenze Visualizza.

Sintassi:

--compare="<path of project file>" "<path of reference project file>"
Esempio 47. Esempio
CODESYS.exe --compare  "D:\proj\project1.project"  "D:\proj\project2.project"


Opzione: --project (apri CODESYS progetto)

CODESYS viene avviato e il progetto specificato viene aperto.

Sintassi:

--project="<path of project file>"

<path of project file>: Percorso del file del progetto

Esempio 48. Esempio

Apri il test progetto:

CODESYS.exe --culture=de --project="D:\projects\test.project"


Opzione: --projectarchive (open CODESYS archivio progetti)

CODESYS viene avviato, viene estratto l'archivio del progetto specificato e il progetto viene aperto.

Sintassi:

--projectarchive="<path of projectarchive file>"

<path of project archive file>: Percorso del file dell'archivio del progetto

Esempio 49. Esempio

Estrarre il test.projectarchive e aprire il progetto nel sistema di sviluppo:

CODESYS.exe --projectarchive="D:\projects\test.projectarchive"


Opzione: --runscript (esegui script)

Il file di script specificato viene eseguito da CODESYS.

Tabella 8. Opzioni della riga di comando per --runscript

--runscript="<script file>.py"

CODESYS esegue il <script file>.py file di script all'avvio.

Devi fornire il percorso completo del file di script.

--scriptargs:'<arg1> <arg2> ... <argn>'

Utilizzare questa opzione con il --runscript opzione. Attivano il passaggio degli argomenti <arg1> … <argn> allo script. Gli argomenti vengono passati alla variabile Python sys.argv.

--noUI

Utilizzare questa opzione con il --runscript opzione.

Il CODESYS l'interfaccia utente non è aperta. CODESYS restituisce tutti gli errori, gli avvisi, i report del compilatore e i messaggi della riga di comando generati dallo script. I messaggi di script (1: Severity Text) possono essere separati dagli altri messaggi (2: Severity FatalError, Error, Warning, Information) con il > operatore.

--enablescripttracing

Utilizzare questa opzione con il --runscript opzione. Di conseguenza, ogni comando del file di script viene visualizzato nell'output.

--textPrompts

Utilizzare questa opzione con il --noUI opzione. Di conseguenza, i metodi del servizio messaggi e le finestre di dialogo predefinite vengono emessi nella riga di comando per l'input dell'utente.

Se non specifichi --textPrompts, quindi tutte le richieste del servizio messaggi vengono confermate automaticamente con i valori predefiniti.

scriptdebugger {="<debugger>"}

Utilizzare questa opzione con il --runscript opzione. Imposta IronPython in modalità di debug in modo che i debugger esterni possano essere utilizzati per eseguire il debug degli script Python. I seguenti valori sono definiti per <debugger> (senza distinzione tra maiuscole e minuscole):

  • auto: rileva automaticamente se un debugger è incluso in ogni script per il processo corrente. Al momento, solo i debugger basati su .NET possono essere rilevati automaticamente. Un debugger rilevato sovrascrive il file --enablescripttracing bandiera.

  • .NET: attiva il debug per i debugger basati su .NET, come "Python Tools for Visual Studio" (PTVS) e SharpDevelop. Con questa opzione, un debugger può anche essere incluso negli script in esecuzione, al contrario di "auto".

    Nota: questo è attualmente il valore predefinito quando --scriptdebugger viene utilizzato senza fornire un valore.

  • disabled: Disattiva il debug e il rilevamento automatico.

  • script: imposta il motore di script IronPython in modalità debug per attivare il debug per i debugger set-trace. Lo script stesso deve connettersi e disconnettersi dal debugger.

  • tracing: Attiva la modalità semplice integrata di "tracciatura degli script" e disattiva il rilevamento automatico (come l'opzione --scripttracing).

  • $absolute_path.py$: percorso assoluto di uno script Python che avvia la connessione a un debugger basato su Python. Il motore di script IronPython è passato alla modalità di debug per consentire il debug per i debugger set-trace. Questo script viene eseguito una volta durante l'inizializzazione e dovrebbe definire le seguenti funzioni non parametrizzate:

    scriptdebuggersetup viene eseguito immediatamente prima dell'esecuzione dello script utente per stabilire la connessione al debugger.

    scriptdebuggershutdown viene chiamato immediatamente dopo l'esecuzione dello script utente o quando viene scaricato il motore di script e dovrebbe chiudere la connessione al debugger.



Esempio 50. Esempi di utilizzo dei parametri di trasferimento nei file di script con 'sys.argv'
start /b /wait CODESYS.exe
--runscript="D:\Script\ArgvAnd__main__Test.py"
--scriptargs:'username password 3.14 "path=\"C:\temp\\"'

File di script: ArgvAnd__main__Test.py

from __future__ import print_function
import sys
print("sys.argv: ", len(sys.argv), " elements:")

for arg in sys.argv:
    print(" - ", arg)
print()
print("__name__: ", __name__)

Risultato dell'output: stdout:

sys.argv: 6 elements:
- D:\TestScripts\ArgvAnd__main__Test.py
- username
- password
- 3.14
- path= "C:temp"
__name__: __main__

Per ulteriori informazioni sul __name__ variabile globale, vedere la documentazione di Python.



Esempio 51. Esempi dell'output del messaggio
start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 1>ScriptMessages.txt

CODESYS passa tutti i messaggi generati dallo script a ScriptMessages.txt file. Gli altri messaggi vengono stampati sulla riga di comando.

start /b /wait CODESYS.exe --runscript="D:\Script\AmpelTest.py" --noUI 2>NUL

CODESYS sopprime tutti i messaggi, ad eccezione dei messaggi di script. I messaggi di script vengono stampati sulla riga di comando.



Esempio 52. Esempio di utilizzo dell'opzione –scriptdebugger

Il seguente initdebug.py lo script è stato testato con successo con pydevddebugger basati su, come PyDev / LiClipse e PyCharm. Per utilizzare questo script, avvia CODESYS con la seguente riga di comando:

--profile="Fanta Development Build" --scriptdebugger="D:\test\charmdebug\initdebug.py"

File: initdebug.py:

from _future_ import print_function
from _future_ import unicode_literals
import sys
sys.path.append(r"D:\test\Env2\Lib\site-packages\pycharm-debug.egg")
import pydevd
def scriptdebuggersetup():
pydevd.settrace('localhost', port=51234, stdoutToServer=True, stderrToServer=True)
def scriptdebuggershutdown():
pydevd.stoptrace()


Per ulteriori informazioni, vedere: Utilizzo di script e http://docs.python.org/tutorial/modules.html

Opzione: --ignorewhitespace (ignora gli spazi bianchi nel confronto del progetto)

Se aggiungi questa opzione dopo l'opzione --compare <project1> <project2>, quindi gli spazi bianchi vengono ignorati nel confronto del progetto. Si noti che gli spazi semanticamente rilevanti, ad esempio in STRING letterali, sono ancora presi in considerazione.

Sintassi

--compare="<path of project file>" "<path of reference project file>" --ignorewhitespace="true"|"false"
Esempio 53. Esempio
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorewhitespace="true"


Opzione: --ignorecomments (ignora i commenti nel confronto del progetto)

Se aggiungi questa opzione dopo l'opzione --compare <project1> <project2>, i commenti vengono ignorati nel confronto del progetto.

Sintassi:

--compare="<path of project file>" "<path of reference project file>" --ignorecomments="true"|"false"
Esempio 54. Esempio
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignorecomments="true"


Opzione: --ignoreproperties (ignora le proprietà dell'oggetto nel confronto del progetto)

Se aggiungi questa opzione dopo l'opzione --compare <project1> <project2>, le proprietà dell'oggetto (autorizzazioni, impostazioni di compilazione, directory, bitmap, ecc.) vengono ignorate nel confronto del progetto.

Sintassi:

--compare="<path of project file>" "<path of reference project file>" --ignoreproperties="true"|"false"
Esempio 55. Esempio
CODESYS.exe --compare "D:\proj\project1.project" "D:\proj\project2.project" --ignoreproperties="true"


Opzione: --skipunlicensedplugins (non caricare componenti senza licenza)

CODESYS è iniziato. In questo caso, la domanda se i componenti senza licenza devono ancora essere caricati viene ignorata. Se è così, allora CODESYS fa non caricare silenziosamente questi componenti.

Esempio 56. Esempio
CODESYS.exe –skipunlicensedplugins


Opzione: --signaturethumbprint (identificazione personale del certificato utilizzato per firmare le librerie compilate)

Se aggiungi questa opzione dopo l'opzione --project="<path of project file>", quindi il progetto viene aperto e viene passata l'identificazione personale del certificato per la firma delle librerie compilate.

Sintassi:

--signaturethumbprint="<thumbprint of digital signature>"
Esempio 57. Esempio
CODESYS.exe --project="D:\projects\test.project" signaturethumbprint="3E96C9B61010CBDC3186021A1CAA64946DDCAAF3"


Opzione: --enforcesignedcompiledlibraries (applica la firma delle librerie compilate)

Se aggiungi questa opzione dopo l'opzione --project="<path of project file>", poi il Applicare la firma delle librerie compilate l'opzione è abilitata nel progetto in Schermo di sicurezza sul Utente scheda.

Importante

Quando il Schermo di sicurezza viene aperto e richiuso, le impostazioni correnti vengono applicate nelle opzioni utente, anche quando non sono state apportate modifiche attive.

Sintassi:

--enforcesignedcompiledlibraries
Esempio 58. Esempio
CODESYS.exe --project="D:\projects\test.library" --enforcesignedcompiledlibraries


Opzione: --timestampingserverurl (imposta l'indirizzo del server timestamp)

Se aggiungi questa opzione dopo l'opzione --project="<path of project file>", quindi l'indirizzo Internet del server timestamp RFC-3161 (Server di marcatura temporale) è impostato nel progetto in Schermo di sicurezza sul Utente scheda.

Importante

Quando il Schermo di sicurezza viene aperto e richiuso, le impostazioni correnti vengono applicate nelle opzioni utente, anche quando non sono state apportate modifiche attive.

Sintassi:

--timestampingserverurl="<URL of RFC-3161 timestamping server>"
Esempio 59. Esempio
CODESYS.exe --timestampingserverurl="http://timestamp.comodoca.com/rfc3161"


Opzione: --enableEventLog

CODESYS viene avviato e tutte le esecuzioni dei comandi vengono registrate nel registro eventi di Windows. I record si trovano in Windows Visualizzatore eventi Sotto Registri applicazioni e servizi → AP.

Quando si utilizza questa opzione per la prima volta, CODESYS deve essere avviato con i permessi di amministratore.

Sintassi:

--enableEventLog="CommandManager"

Opzione: --ForceDisconnectAfterInactivity

Per questo CODESYS sessione, il tempo di inattività dopo il quale la connessione al controller viene automaticamente interrotta viene impostato sul tempo specificato (in secondi). Il valore specificato in questa opzione sovrascrive il valore impostato nel file CODESYS opzioni in in linea categoria per questo CODESYS sessione.

Se il valore è impostato su 0, la connessione al controller non verrà interrotta automaticamente dopo un determinato periodo di inattività. Per questo CODESYS sessione, questo disabilita l'opzione di disconnessione nel file CODESYS opzioni.

Sintassi:

--ForceDisconnectAfterInactivity="<value in seconds>"
<value in seconds> : [10, 10800] | 0
Esempio 60. Esempio

Dopo 300 secondi di inattività, la connessione al controller verrà interrotta automaticamente.

--ForceDisconnectAfterInactivity="300"